home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / LANG / LISP / FOOLS / !ReadMe next >
Text File  |  1994-11-19  |  4KB  |  103 lines
  1. Fools' Lisp Documentation
  2. -------------------------
  3.  
  4. This is the first release for Acorn Archimedes / RiscPC platforms of
  5. Fools Lisp. It originated on Unix systems, but after some mild hackery
  6. with the sources it now compiles under both UnixLib and Clib on the Arch.
  7. This version uses Clib - the good thing about this being that we get a
  8. wimpslot extending malloc - if it needs more memory then it'll get it...
  9.  
  10.  
  11. Things that are here
  12. --------------------
  13. After some fiddling,
  14.     (require '<package>)
  15. works. Examine the end of !Fl.scm.extra to see what I've done to it -
  16. alternatively grep it for 'ams' and you should see the changes - which were
  17. minimal.
  18. Packages are looked for in the current directory, and in !Fl.scm by default;
  19. you can add to these paths if you wish. (Again see the scheme source for
  20. how to do this...)
  21.  
  22. This has a working extend-syntax; simply do
  23.     (require 'extend)
  24. either at the top of your scheme source, then loading your source ensures
  25. extend is present, or type it in at the prompt.
  26.  
  27. There is an alias 'fools' setup to run Fools lisp in a taskwindow, edit
  28. the !Fl.!Boot, !Fl.!Run files to change this alias - or simply change which
  29. of the aliases there present is commented.
  30.  
  31.  
  32. Things that may or may not be here
  33. ----------------------------------
  34. We don't have a fancy WIMP interface. (Err there are a number of things you
  35. can do about this...)
  36.  
  37. file-truncate not present. (Seeing as it isn actually in R3RS/R4RS I cant see
  38. this as problem..)
  39.  
  40. file-mode not present. (This too isnt in the standard and hence unnecessary..
  41. well actually it's because it uses Unix-isms we don't have on the Arch..)
  42.  
  43. file-access is present. HOWEVER it cannot be relied on to give true typing of
  44. the file - currently it will merely return whether the file is present or not;
  45. i.e. the second argument is paid no heed to. (Reason for this being it's used
  46. by require to check if a file exists and not much else; so I hacked it around
  47. not to use an access() call...)
  48.  
  49. file-string not present. (Not in standard and uses stat())
  50.  
  51. chdir is present. (Very very very hacky but will do the job - relies on
  52. excessively non portable behaviour of system calls on Arch - changing dir
  53. via a system() leaves it intact after  returning to calling program - this is
  54. NOT the case under Unix.)
  55.  
  56. sleep is present. It isnt entirely likely to give you seconds worth of delay.
  57. But it will give you a delay...
  58.  
  59. ln1+ not present. Havent got a clue what this is and not seen it in any other
  60. Scheme interpreters. Definitely isnt in standard.
  61.  
  62. exp-1 not present. As per ln1+.
  63.  
  64.  
  65. Things that may get put in
  66. --------------------------
  67. I might (if I get time ;-) put in my graphics package to let you have
  68. simple drawing commands - currently this works in my port of SCM and nothing
  69. else. (I considered putting itinto SIOD but thought better of it...)
  70. Might happen but dont hold your breath.
  71.  
  72.  
  73. Features
  74. --------
  75. (require '<package-name>)
  76. doesnt shut the files until exiting fools lisp - hence editing them whilst
  77. you have the required in another window is liable to give file open errors.
  78. Hence - use load if at all possible. (As it doesnt seem to suffer from this..)
  79.  
  80. Compiling in support for the Memory blocks breaks it under clib and unixlib.
  81. Dont know if this makes much of a difference using malloc() in preference.
  82.  
  83.  
  84. PPS
  85. ---
  86. If anyone actually uses this they could send me an email message saying so..
  87. If anyone wants the patched sources that make it compile under UnixLib/Clib
  88. then get in touch and I'll oblige.
  89.  
  90.  
  91. Any bugs / features / gripes / other,
  92.  
  93. please contact me at either:
  94.  
  95. Snail:
  96.     Al Slater,
  97.     Kintail,
  98.     Barclay Park,
  99.     Aboyne,
  100.     Aberdeenshire.
  101.     AB34 5JF.
  102.  
  103. Email:    ams@csd.abdn.ac.uk        ; good til June '95.